home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / ril.zip / README < prev    next >
Text File  |  1992-09-08  |  5KB  |  106 lines
  1.  
  2. This is the README file for RIL, version 1
  3.  
  4.  
  5. What is RIL?
  6.     RIL - "Roger's Interface Language", is basically a "preprocessor" 
  7.     for Resource files.  At a minimum, RIL allows you to write resource
  8.     files in a clean, easy to read and edit style, as "source code"
  9.     for the generation of a true "app-defaults" file.  
  10.  
  11.     Taken to extremes, RIL allows you to use conditional statements,
  12.     flow control constructs, user-definable procedures and variables,
  13.     and a whole lotta other neat stuff, to specify your interface.
  14.     
  15.     RIL is based on TCL.  If you do not have TCL, you need to get it.
  16.     TCL can be FTP'd from sprite.berkely.edu, among other places.
  17.     TCL is really the guts behind RIL, and it comes with reasonable
  18.     documentation on the details of the language.
  19.     If you already use TCL, you can use the version that you already have
  20.     with some minor edits in the Imakefile.
  21.  
  22.     RIL has about 3 "modes" of operation:
  23.     1. Write ril scripts and "compile" them to app-defaults files
  24.        These app-defaults files can be used any place an ordinary
  25.        resource file can be used. (as app-defaults, fallbacks, Mri...)
  26.        Usually by the end of a project, I have several .ril source files
  27.        which are used to create a .ad file for the application.
  28.  
  29.     2. Use the program "ril" to run an application from its ril source.
  30.        This is analagous to using Mri on a plain resource file, and is
  31.        an excellent way to quickly prototype an interface.
  32.     
  33.     3. Link libril.a with an application, and use ril source instead
  34.        of resource files.  This is most useful if you are already using
  35.        WCL.  This is how I build all my Motif apps these days.
  36.        This provides a very convenient cycle for developing interfaces,
  37.        there is no "compiling" of the ril files.  They are read each
  38.        time the program runs.  It takes a few seconds longer at start
  39.        up time, but it beats forgetting to "make" the .ad file and
  40.        then wondering why your changes didn't show up!
  41.  
  42.     Please be aware that this is the first release of RIL, and
  43.     has many rough edges, especially in the area of documentation.
  44.     I have chosen to make RIL available at this early stage, in order
  45.     to get user feedback that will help me to see better what is needed
  46.     the most.  Future revisions of RIL will include better documentation,
  47.     and more examples which better show the "fine points" of RIL.
  48.  
  49.     I WELCOME your comments and suggestions!!!
  50.  
  51. Who should use RIL?
  52.     Anybody that generates complex resource files can benefit from 
  53.     using RIL.  In particular,  users of WCL will find RIL an
  54.     invaluable tool,  because WCL allows/demands "complete" resource
  55.     files, which can get really large and ugly.
  56.  
  57.     Also, you can think of RIL as a kind of substitute for UIL.
  58.     This is may especially interesting for OLIT and ATHENA users.
  59.  
  60. What do I need to get to use RIL, and where do I get it?
  61.     You need to get ril.tar.Z from ftp on export.lcs.mit.edu in /contrib
  62.     or from alt.sources.
  63.  
  64.     RIL requires TCL 6.3. If you already have TCL 6.3 or later, you can
  65.     use that. Otherwise, get it from sprite.berkely.edu
  66.  
  67.     RIL works best in conjunction with WCL, though WCL is not required.
  68.     If you don't have WCL you should get it, whether you use RIL or not!
  69.     The most recent version is also available on export.
  70.  
  71. How do I learn to use RIL?
  72.     There are some demo "programs" in the distribution which should
  73.     serve as a guide to using RIL, and the basics of TCL.
  74.     For a more complete description of the full potential of RIL,
  75.     you can read the TCL documentation included in the TCL distribution.
  76.     If you already use WCL, you should be able to get quite a long 
  77.     very quickly just by looking over the examples.
  78.  
  79.     The file ril_main.c is a demonstration of how you would incorporate
  80.     the use of ril into an application, as suggested in method 3 above.
  81.  
  82.  
  83. What is the future of RIL?
  84.     Well, thats a good question.  RIL is only a few months old, and
  85.     I myself have not had a chance to try all of the things which I
  86.     have tried to provide hooks to do.
  87.  
  88.     Some things that sould be possible with RIL, but I have not yet
  89.     tried, or don't have examples of, are:
  90.         Building a library of re-usable high-level interface components.
  91.         Defining and using resource "styles".
  92.         
  93.     Some features that I had envisioned, but have not yet implemented
  94.     are:
  95.         Genereate C-code from ril source.
  96.         Error checking on resource specifications.
  97.         Additional language features.
  98.         Suggestions from the world...
  99.  
  100. Sytems tested:
  101.     I use RIL extensively on a Sun Sparcstation 2, with SunOs 4.1.1,
  102.     X11r5, and Motif 1.1.4
  103.     I have used it with other versions of X and Motif on Suns.
  104.     I have used it on HPUX something or other.
  105.     I would like to hear of other platforms on which it runs successfully.
  106.